home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 051-075 / scopedisk70 / showfonts / showfont.doc < prev    next >
Text File  |  1995-03-19  |  13KB  |  231 lines
  1.                        ShowFont 3.3 - by Arthur Johnson Jr.
  2.                        ====================================
  3.  
  4.                             Last update date - 02/11/89
  5.                             ---------------------------
  6.  
  7.   ****************************************************************************
  8.   * To see just the changes since revision ?.?, check out the improved       *
  9.   * "Revisions n' Updates" section at the end of this documentation!         *
  10.   ****************************************************************************
  11.  
  12.        This program allows you to quickly and painlessly view all 256
  13.   characters in a typical font.  I wrote it because using FontEd or (choke!)
  14.   NotePad to see what a font looks like can be slow, tedious, monotonous, etc.
  15.  
  16.        To use this program, simply type "ShowFont [font_name] [font_size]".
  17.   Both the [font_name] (Topaz, Ruby, etc.) and [font_size] (8, 12, etc.) are
  18.   purely optional.  If you do not specify a size, ShowFont will check all your
  19.   available fonts and then show you what sizes/styles of the font you wanted
  20.   exist.  If you also omitted the font, you can select what font/size/style to
  21.   see by using the font requester.  More on this below.  Note that you
  22.   currently cannot select a [font_style] to see.  You must do this through the
  23.   requester.  Also, ShowFont currently hits the fan when it encounters a SIZE
  24.   with multiple styles, i.e., italics AND underlined.  It won't bomb, but it
  25.   "has trouble" finding/displaying the correct font.  I'll try to fix this in
  26.   version 3.4.
  27.  
  28.        By the way, if someone makes an icon for this program, it might just
  29.   run from WorkBench.  Since I never use WorkBench, I haven't bothered testing
  30.   this.  (Version 3.3 note:  What?  Load WorkBench?  Feh.)
  31.  
  32.        So, what's the font selector like?  Well, I've tried to make it pretty
  33.   standard, including all the neat features most of the better ones have.  To
  34.   select a font, size, or style, simply click on it with the left button.
  35.   When you have the desired font, size, and style selected, press the OK
  36.   button.  You can now (3.1) just double-click on the font, size, or style to
  37.   view the font, size, and style you like.
  38.        To scroll around the font, size, and style lists, click on the arrows
  39.   or slider gadgets.  Since you've probably used their like in other programs,
  40.   you probably already know what they do.  Note that you can hold down the
  41.   left button over these gadgets and the list will scroll rapidly (Version 3.2
  42.   note: extremely rapidly) in the direction of the arrow you're over.  You can
  43.   also do this with the slider gadget and move up and down to scroll over the
  44.   whole list.  To stop the scrolling, release the button.
  45.        If you decide you really don't want to look at a different font than
  46.   what you had been checking out, press the CANCEL button.
  47.  
  48.   /**************************************************************************/
  49.   /*      Because most everyone changes their Preferences colors, the       */
  50.   /* colors I mention below might not be correct for your system.  Just     */
  51.   /* translate what the colors should be on your system (if you've changed  */
  52.   /* them).  The original colors were blue, white, black, and orange (in    */
  53.   /* order of how you can change them in Preferences).  Just look to see    */
  54.   /* what your colors are where and things should be pretty easy to         */
  55.   /* understand.  Then again, they may not.                                 */
  56.   /**************************************************************************/
  57.  
  58.        If the sizes of the font you've selected are printed in WHITE, the
  59.   font is non-proportional (TOPAZ).  If they are printed in ORANGE, they are
  60.   proportional (most everything else).  I added this so you can easily see
  61.   what fonts you may have are non-proportional, since they are real nice when
  62.   trying to make tables and stuff that needs to be columnarly [sic?]
  63.   organized.  If you don't understand what I'm talking about, non-proportional
  64.   fonts take up the same number of pixels per character, i.e., an 'i' takes
  65.   as much space as an 'm'.  Proportional fonts space the characters according
  66.   to how wide they are, i.e., an 'i' would definitely take less space to
  67.   write than an 'm'.  Don't know what a pixel is?  Pixels are the small dots
  68.   that can be seen if you press your face to your terminal screen.  What's
  69.   a terminal screen?  Well, etc., etc.
  70.  
  71.   ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  72.   The above explanation is a perfectly good RECURSIVE DEFINITION example.
  73.   But anyway, back to the documentation.
  74.   ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
  75.  
  76.        Clicking CANCEL when you've just booted the program without any default
  77.   font will cause the program to display TOPAZ 11 (if it exists).  I don't know
  78.   why it doesn't use TOPAZ 8.  I've tried to tell it to many times and in many
  79.   ways, but it ignores me.  C'est la vie.  But you would never do that anyway,
  80.   would you?  Someday, I'll try to track down and eliminate this one-time
  81.   fault.  Version 3.3 note: I HATE THIS PROBLEM!!!
  82.  
  83.        * NOTE * ShowFont looks in the FONTS: directory for all its fonts.
  84.        If you wish to look in another fonts directory (because you split up
  85.        your fonts into separate directories to please programs like DPaint),
  86.        exit ShowFont, re-ASSIGN FONTS: to whatever directory you like, and
  87.        then re-run ShowFont.
  88.  
  89.        For a change, I think I will try to organize this documentation a bit
  90.   by listing all the menus and what each selection does.  If this is too
  91.   orderly for you, please call and tell me and I'll try to make it more
  92.   confusing next time.
  93.  
  94.   Menu    - Option           What is it?
  95.   --------------------       -----------
  96.   Project - About            Gives some useless information about the program.
  97.   Project - Quit             Exits the program.
  98.  
  99.   Fonts   - Font Selection   Brings up the font selecting requester.
  100.  
  101.   Screen  - 320 x 200        Changes the screen size to 320 x 200.
  102.   Screen  - 320 x 400        Uhm...
  103.   Screen  - 640 x 200        Duh...
  104.   Screen  - 640 x 400        ???...
  105.  
  106.        Notice that all the menu options except the 'Screen' menu stuff have
  107.   short key-equivalents, i.e., you can press Right Amiga-? to select that
  108.   menu selection, where ? is whatever letter is displayed after the neat
  109.   Amiga symbol in the menu.
  110.  
  111.        If the font is found, ShowFont will display "font_name-font_size" in
  112.   the upper left-hand corner of the screen next to the CLOSE gadget.  To see
  113.   the rest of the font (if all 256 characters cannot fit on the screen at
  114.   once), use the three gadgets on the right-hand side of the screen.  Again,
  115.   their function closely resembles their appearance.  Fiddle around for about
  116.   three seconds and you will be quite familiar and comfortable with scrolling
  117.   around a font.  Again, you can just hold down the button and scroll happily
  118.   in whatever direction you like.
  119.  
  120.        Note that actually all 256 characters will not be displayed if there
  121.   are blank (empty) characters.  The program will skip them, since they are
  122.   rather uninteresting, being blank.  The program will display that segment
  123.   of the characters that the font says should be displayed.  Two-to-one
  124.   someone has some neat secret graphics just outside the official display
  125.   range, but we'll never know.
  126.  
  127.       As of version 3.3, I've added the ability to find out just how to get
  128.   that neat graphics character you see.  Just click on the character, and a
  129.   little requester will pop up and tell you what keys to press to get it.
  130.   The alphabetic keys (A -> Z) will all be in upper-case.  That does NOT
  131.   mean you have to (for example), press ALT-SHIFT-A when you see 'ALT-A'.
  132.   Just press the ALT and then the A keys.  Only press SHIFT when it explicitly
  133.   tells you to.  The lowercase 's' and 'm' you might see refer to the SPACE
  134.   BAR and KEYPAD MINUS (-), respectively (not sexual practices - whoops!).
  135.  
  136.   * NOTE * Anything telling you to press CONTROL-[ALT-]_ is suspicious, as I
  137.   did not have a table for the characters from decimal 0 -> 31, and 128 ->
  138.   159.  Take the "press..." advice with a grain o' salt for these characters.
  139.   If some kind soul will send me a complete keymap with those values noted,
  140.   I will add them.  Note that CONTROL-? or CONTROL-ALT-? means that ShowFont
  141.   THINKS you press CONTROL (or CONTROL-ALT) to get that character, but does
  142.   not know what particular key.  Sorry.  Hopefully, that'll all be cleared up
  143.   in 3.4.
  144.  
  145.        To exit the program, click on the CLOSE gadget or select the menu
  146.   "Quit" option or press Right-Amiga-Q.  I like three ways to end a program!
  147.   Actually, you can also end the program by:
  148.        1) Control Amiga-Amiga
  149.        2) Turning off your computer's power
  150.        3) Striking the system with great force with a large, blunt object
  151.   That now makes a total of six ways to terminate the program.  I'm sure
  152.   clever people will find even more imaginative and useful ways to end the
  153.   font session.
  154.  
  155.        I guess the best advice I can give you for using and understanding this
  156.   program is to type 'showfont' from CLI and fiddle around for a while until
  157.   you either comprehend all the features or delete the program in a fit o'
  158.   passion.  In fact, most bugs are detected this way through random menu and
  159.   gadget selecting.
  160.  
  161.        I'll apologize now for this rather random and odd documentation file,
  162.   but I'm usually dazed and confused after my program successfully runs
  163.   without any apparent bugs.  On a technical note, the Lattice 5.0 C "big"
  164.   compiler and global optimizer compiled this program without comment.  I like
  165.   that.  I used the following to compile the program:
  166.  
  167.                    lc -g -L -M -O showfont sfstructs
  168.                    fixhunk showfont
  169.  
  170.        I would like to thank the National Type Foundry for sending me some
  171.   fonts, and the CityDesk creators for that program.
  172.  
  173.       As you might have guessed from reading all the references to version
  174.   3.4, it'll probably be a while before it comes out.  College is actually
  175.   getting rather time-intensive, so I don't know when the next version will be
  176.   available.  I thought that the new feature (and the embarrassing bug fix)
  177.   warranted a release of 3.3.  Especially since 3.4 might have to wait for the
  178.   Amiga 3000. 8-)
  179.  
  180.        That's it!  Any comments/questions/suggestions/flames/improvements/
  181.   etc., can be directed to the following address:
  182.  
  183.                          *****************************
  184.                          * Arthur Johnson Jr.        *
  185.                          * 225 Montego Bay Court     *
  186.                          * Merritt Island, FL  32953 *
  187.                          *      (407) 277-0548       *
  188.                          *****************************
  189.  
  190.   ...or any of the following electronic addresses:
  191.  
  192.   Arthur Johnson Jr. -=> {uiucuxc, hoptoad, petsd}!peora!rtmvax!bilver!alj
  193.   -=-=-=-=-=-=-=-=-  -=> alj@bilver.UUCP
  194.                      -=> PLink: DUNG
  195.                      -=> GEnie: A.JOHNSONJR
  196.  
  197.   -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  198.        I guess I should add that this program and source are PUBLIC DOMAIN in
  199.   all ways, except that if you dare to sell this program by itself for fun n'
  200.   profit, you will be found and terminated.  Other than that, feel free to do
  201.   whatever you like with the program, although give me some credit somewhere...
  202.   -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  203.  
  204.                                Revisions n' Updates
  205.                                --------------------
  206.  
  207.   Version 3.3 : Fixed a bug that caused ShowFont to lump similiarly-named
  208.                  fonts together (whoopsie!).
  209.                 Added "To get that character, press..." feature.
  210.  
  211.   Version 3.2 : Eliminated slider gadgets happy post-release flickering.
  212.                 Returned a satisfactory response to the system when exiting
  213.                  from a RUN-ned ShowFont, exterminating that error message.
  214.                 Polished the code up quite a lot for some noticeable speed
  215.                  and size improvements.
  216.                 Worked on the documentation some more (this will be assumed
  217.                  for all future versions)
  218.                 Discarded the somewhat useless and potentially dangerous
  219.                  "Read FONTS:" menu option.
  220.                 A few other little thingies.
  221.  
  222.   Version 3.1 : Fixed a bug in the 'Read FONTS:' menu selection.
  223.                 Added "double-clicking" selection method.
  224.                 Cleaned up the documentation a bit.
  225.  
  226.   Version 3.0 and below : These records were destroyed in the great fire,
  227.                           earthquake, plague, hurricane, tsunami, volcanic
  228.                           eruption, insect infestation, computer virus, and
  229.                           alien attack of 1988.  I apologize for any
  230.                           inconvenience this may cause.
  231.